OrderedBag Members

Wintellect PowerCollections

Collapse imageExpand ImageCollapseAll imageExpandAll imageDropDown imageDropDownHover imageCopy imageCopyHover image
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Syntax

C#
[SerializableAttribute]
public class OrderedBag<T>
Visual Basic (Declaration)
<SerializableAttribute> _
Public Class OrderedBag(Of T)
Visual C++
[SerializableAttribute]
generic<typename T>
public ref class OrderedBag

Type Parameters

T

The type exposes the following members.

Public Constructors

  NameDescription
Public methodOrderedBag<(Of <T>)>OrderedBag<(Of <T>)>NewOverloaded.

Public Methods

  NameDescription
Public methodAdd
Must be overridden to allow adding items to this collection.
Public methodAddMany
Adds all the items in collection to the bag.
Public methodAsList
Get a read-only list view of the items in this ordered bag. The items in the list are in sorted order, with the smallest item at index 0. This view does not copy any data, and reflects any changes to the underlying OrderedBag.
Public methodAsReadOnly
Provides a read-only view of this collection. The returned ICollection<T> provides a view of the collection that prevents modifications to the collection. Use the method to provide access to the collection without allowing changes. Since the returned object is just a view, changes to the collection will be reflected in the view.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodClear
Removes all items from the bag.
(Overrides CollectionBase<(Of <T>)>..::Clear()().)
Public methodClone
Makes a shallow clone of this bag; i.e., if items of the bag are reference types, then they are not cloned. If T is a value type, then each element is copied as if by simple assignment.
Public methodCloneContents
Makes a deep clone of this bag. A new bag is created with a clone of each element of this bag, by calling ICloneable.Clone on each element. If T is a value type, then each element is copied as if by simple assignment.
Public methodContains
Determines if the collection contains a particular item. This default implementation iterates all of the items in the collection via GetEnumerator, testing each item against item using IComparable<T>.Equals or Object.Equals.
Public methodConvertAll<(Of <TOutput>)>
Convert this collection of items by applying a delegate to each item in the collection. The resulting enumeration contains the result of applying converter to each item in this collection, in order.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodCopyTo
Copies all the items in the collection into an array. Implemented by using the enumerator returned from GetEnumerator to get all the items and copy them to the provided array.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodCountWhere
Counts the number of items in the collection that satisfy the condition defined by predicate.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodDifference
Computes the difference of this bag with another bag. The difference of these two bags is all items that appear in this bag, but not in otherBag. If an item appears X times in this bag, and Y times in the other bag, the difference contains the item X - Y times (zero times if Y >= X). A new bag is created with the difference of the bags and is returned. This bag and the other bag are unchanged.
Public methodDifferenceWith
Computes the difference of this bag with another bag. The difference of these two bags is all items that appear in this bag, but not in otherBag. If an item appears X times in this bag, and Y times in the other bag, the difference contains the item X - Y times (zero times if Y >= X). This bag receives the difference of the two bags; the other bag is unchanged.
Public methodDistinctItems
Enumerates all the items in the bag, but enumerates equal items just once, even if they occur multiple times in the bag.
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Public methodExists
Determines if the collection contains any item that satisfies the condition defined by predicate.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodFindAll
Enumerates the items in the collection that satisfy the condition defined by predicate.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodForEach
Performs the specified action on each item in this collection.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodGetEnumerator
Returns an enumerator that enumerates all the items in the bag. The items are enumerated in sorted order.
(Overrides CollectionBase<(Of <T>)>..::GetEnumerator()().)
Public methodGetEqualItems

Enumerates all of the items in this bag that are equal to item, according to the comparison mechanism that was used when the bag was created. The bag is not changed.

If the bag does contain an item equal to item, then the enumeration contains no items.

Public methodGetFirst
Returns the first item in the bag: the item that would appear first if the bag was enumerated. This is also the smallest item in the bag.
Public methodGetHashCode
Serves as a hash function for a particular type. GetHashCode()() is suitable for use in hashing algorithms and data structures like a hash table.
(Inherited from Object.)
Public methodGetLast
Returns the last item in the bag: the item that would appear last if the bag was enumerated. This is also the largest item in the bag.
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodIndexOf
Get the index of the given item in the sorted order. The smallest item has index 0, the next smallest item has index 1, and the largest item has index Count-1. If multiple equal items exist, the smallest index of the equal items is returned.
Public methodIntersection
Computes the intersection of this bag with another bag. The intersection of two bags is all items that appear in both of the bags. If an item appears X times in one bag, and Y times in the other bag, the sum contains the item Minimum(X,Y) times. A new bag is created with the intersection of the bags and is returned. This bag and the other bag are unchanged.
Public methodIntersectionWith
Computes the intersection of this bag with another bag. The intersection of two bags is all items that appear in both of the bags. If an item appears X times in one bag, and Y times in the other bag, the sum contains the item Minimum(X,Y) times. This bag receives the intersection of the two bags, the other bag is unchanged.
Public methodIsDisjointFrom
Determines if this bag is disjoint from another bag. Two bags are disjoint if no item from one set is equal to any item in the other bag.
Public methodIsEqualTo
Determines if this bag is equal to another bag. This bag is equal to otherBag if they contain the same items, each the same number of times.
Public methodIsProperSubsetOf
Determines if this bag is a proper subset of another bag. Neither bag is modified. This bag is a subset of otherBag if every element in this bag is also in otherBag, at least the same number of times. Additional, this bag must have strictly fewer items than otherBag.
Public methodIsProperSupersetOf
Determines if this bag is a proper superset of another bag. Neither bag is modified. This bag is a proper superset of otherBag if every element in otherBag is also in this bag, at least the same number of times. Additional, this bag must have strictly more items than otherBag.
Public methodIsSubsetOf
Determines if this bag is a subset of another bag. Neither bag is modified. This bag is a subset of otherBag if every element in this bag is also in otherBag, at least the same number of times.
Public methodIsSupersetOf
Determines if this bag is a superset of another bag. Neither bag is modified. This bag is a superset of otherBag if every element in otherBag is also in this bag, at least the same number of times.
Public methodLastIndexOf
Get the index of the given item in the sorted order. The smallest item has index 0, the next smallest item has index 1, and the largest item has index Count-1. If multiple equal items exist, the largest index of the equal items is returned.
Public methodNumberOfCopies
Returns the number of copies of item in the bag. More precisely, returns the number of items in the bag that compare equal to item.
Public methodRange
Returns a View collection that can be used for enumerating a range of the items in the bag. Only items that are greater than from and less than to are included. The items are enumerated in sorted order. Items equal to the end points of the range can be included or excluded depending on the fromInclusive and toInclusive parameters.
Public methodRangeFrom
Returns a View collection that can be used for enumerating a range of the items in the bag. Only items that are greater than (and optionally, equal to) from are included. The items are enumerated in sorted order. Items equal to from can be included or excluded depending on the fromInclusive parameter.
Public methodRangeTo
Returns a View collection that can be used for enumerating a range of the items in the bag. Only items that are less than (and optionally, equal to) to are included. The items are enumerated in sorted order. Items equal to to can be included or excluded depending on the toInclusive parameter.
Public methodRemove
Must be overridden to allow removing items from this collection.
Public methodRemoveAll
Removes all the items in the collection that satisfy the condition defined by predicate.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodRemoveAllCopies
Searches the bag for all items equal to item, and removes all of them from the bag. If not found, the bag is unchanged.
Public methodRemoveFirst
Removes the first item in the bag. This is also the smallest item in the bag.
Public methodRemoveLast
Removes the last item in the bag. This is also the largest item in the bag.
Public methodRemoveMany
Removes all the items in collection from the bag. Items not present in the bag are ignored.
Public methodReversed
Returns a View collection that can be used for enumerating the items in the bag in reversed order.
Public methodSum
Computes the sum of this bag with another bag. he sum of two bags is all items from both of the bags. If an item appears X times in one bag, and Y times in the other bag, the sum contains the item (X+Y) times. A new bag is created with the sum of the bags and is returned. This bag and the other bag are unchanged.
Public methodSumWith
Computes the sum of this bag with another bag. The sum of two bags is all items from both of the bags. If an item appears X times in one bag, and Y times in the other bag, the sum contains the item (X+Y) times. This bag receives the sum of the two bags, the other bag is unchanged.
Public methodSymmetricDifference
Computes the symmetric difference of this bag with another bag. The symmetric difference of two bags is all items that appear in either of the bags, but not both. If an item appears X times in one bag, and Y times in the other bag, the symmetric difference contains the item AbsoluteValue(X - Y times). A new bag is created with the symmetric difference of the bags and is returned. This bag and the other bag are unchanged.
Public methodSymmetricDifferenceWith
Computes the symmetric difference of this bag with another bag. The symmetric difference of two bags is all items that appear in either of the bags, but not both. If an item appears X times in one bag, and Y times in the other bag, the symmetric difference contains the item AbsoluteValue(X - Y times). This bag receives the symmetric difference of the two bags; the other bag is unchanged.
Public methodToArray
Creates an array of the correct size, and copies all the items in the collection into the array, by calling CopyTo.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodToString
Shows the string representation of the collection. The string representation contains a list of the items in the collection. Contained collections (except string) are expanded recursively.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodTrueForAll
Determines if all of the items in the collection satisfy the condition defined by predicate.
(Inherited from CollectionBase<(Of <T>)>.)
Public methodUnion
Computes the union of this bag with another bag. The union of two bags is all items from both of the bags. If an item appears X times in one bag, and Y times in the other bag, the union contains the item Maximum(X,Y) times. A new bag is created with the union of the bags and is returned. This bag and the other bag are unchanged.
Public methodUnionWith
Computes the union of this bag with another bag. The union of two bags is all items from both of the bags. If an item appears X times in one bag, and Y times in the other bag, the union contains the item Maximum(X,Y) times. This bag receives the union of the two bags, the other bag is unchanged.

Protected Methods

  NameDescription
Protected methodFinalize
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)

Public Properties

  NameDescription
Public propertyComparer
Returns the IComparer<T> used to compare items in this bag.
Public propertyCount
Returns the number of items in the bag.
(Overrides CollectionBase<(Of <T>)>..::Count.)
Public propertyItem
Get the item by its index in the sorted order. The smallest item has index 0, the next smallest item has index 1, and the largest item has index Count-1.

Explicit Interface Implementations

  NameDescription
Explicit interface implemetationPrivate propertyICollection<(Of <T>)>..::IsReadOnly (Inherited from CollectionBase<(Of <T>)>.)
Explicit interface implemetationPrivate methodICollection..::CopyTo
Copies all the items in the collection into an array. Implemented by using the enumerator returned from GetEnumerator to get all the items and copy them to the provided array.
(Inherited from CollectionBase<(Of <T>)>.)
Explicit interface implemetationPrivate propertyICollection..::IsSynchronized
Indicates whether the collection is synchronized.
(Inherited from CollectionBase<(Of <T>)>.)
Explicit interface implemetationPrivate propertyICollection..::SyncRoot
Indicates the synchronization object for this collection.
(Inherited from CollectionBase<(Of <T>)>.)
Explicit interface implemetationPrivate methodIEnumerable..::GetEnumerator
Provides an IEnumerator that can be used to iterate all the members of the collection. This implementation uses the IEnumerator<T> that was overridden by the derived classes to enumerate the members of the collection.
(Inherited from CollectionBase<(Of <T>)>.)
Explicit interface implemetationPrivate methodICloneable..::Clone
Makes a shallow clone of this bag; i.e., if items of the bag are reference types, then they are not cloned. If T is a value type, then each element is copied as if by simple assignment.

See Also